home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_urt.idb / usr / freeware / catman / u_man / cat1 / rleldmap.Z / rleldmap
Encoding:
Text File  |  1999-01-26  |  7.6 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      RRRRLLLLEEEELLLLDDDDMMMMAAAAPPPP((((1111))))         1111 ((((NNNNoooovvvv 11112222,,,,    1111999988886666))))           RRRRLLLLEEEELLLLDDDDMMMMAAAAPPPP((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       rleldmap - Load a new    color map into an RLE file
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       rrrrlllleeeellllddddmmmmaaaapppp [ ----{{{{aaaabbbb}}}} ] [ ----nnnn _n_c_h_a_n    _l_e_n_g_t_h ] [ ----ssss _b_i_t_s ] [ ----llll [
  13.       _f_a_c_t_o_r ] ] [ ----gggg _g_a_m_m_a    ] [ ----{{{{ttttffff}}}} _f_i_l_e ] [ ----mmmm _f_i_l_e_s ...    ] [ ----rrrr
  14.       _r_l_e_f_i_l_e ] [ ----oooo _o_u_t_f_i_l_e ] [ _i_n_f_i_l_e ]
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.       The program will load    a specified color map into an _R_L_E(5)
  18.       file.     The color map may be computed by _r_l_e_l_d_m_a_p or loaded
  19.       from a file in one of    several    formats.  The input is read
  20.       from _i_n_f_i_l_e or stdin if no file is given, and    the result is
  21.       written to _o_u_t_f_i_l_e or    stdout.
  22.  
  23.       The following    terms are used in the description of the
  24.       program and its options:
  25.  
  26.       input    map:
  27.            A color map already in the input    RLE file.
  28.  
  29.       applied map:
  30.            The color map specified by the arguments    to _r_l_e_l_d_m_a_p.
  31.            This map    will be    applied    to or will replace the input
  32.            map to produce the output map.
  33.  
  34.       output map:
  35.            Unless ----aaaa or ----bbbb is specified, this is equal to the
  36.            applied map.  Otherwise it will be the composition of
  37.            the input and applied maps.
  38.  
  39.       map composition:
  40.            If the applied map is composed _a_f_t_e_r the    input map,
  41.            then the    output map will    be _a_p_p_l_i_e_d _m_a_p[_i_n_p_u_t _m_a_p].
  42.            Composing the applied map before    the input map produces
  43.            an output map equal to _i_n_p_u_t _m_a_p[_a_p_p_l_i_e_d    _m_a_p].  The
  44.            maps being composed must    either have the    same number of
  45.            channels, or one    of them    must have only one channel.
  46.            If an entry in the map being used as a subscript    is
  47.            larger than the length of the map being subscripted,
  48.            the output value    is equal to the    subscript value.  The
  49.            output map will be the same length as the subscript map
  50.            and will    have the number    of channels that is the    larger
  51.            of the two.  If the input map is    used as    a subscript,
  52.            it will be downshifted the correct number of bits to
  53.            serve as    a subscript for    the applied map    (since the
  54.            color map in an _R_L_E(5) file is always stored left
  55.            justified in 16 bit words).  This also applies to the
  56.            applied map if it is taken from an _R_L_E(5) file (----rrrr
  57.            option below).  Note that if there is no    input map,
  58.            that the    result of composition will be exactly the
  59.            applied map.
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 12/1/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      RRRRLLLLEEEELLLLDDDDMMMMAAAAPPPP((((1111))))         1111 ((((NNNNoooovvvv 11112222,,,,    1111999988886666))))           RRRRLLLLEEEELLLLDDDDMMMMAAAAPPPP((((1111))))
  71.  
  72.  
  73.  
  74.       nchan:
  75.            The number of separate lookup tables (channels) making
  76.            up the color map.  This defaults    to 3.
  77.  
  78.       length:
  79.            The number of entries in    each channel of    the color map.
  80.            The default is 256.
  81.  
  82.       bits:
  83.            The size    of each    color map entry    in bits.  The default
  84.            value is    the log    base 2 of the length.
  85.  
  86.       range:
  87.            The maximum value of a color map    entry, equal to
  88.            2**bits - 1.
  89.  
  90.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  91.       ----aaaa   Compose the applied map _a_f_t_e_r the input map.
  92.  
  93.       ----bbbb   Compose the applied map _b_e_f_o_r_e the input    map.  Only one
  94.            of ----aaaa or    ----bbbb may be specified.
  95.  
  96.       ----nnnn _n_c_h_a_n _l_e_n_g_t_h
  97.            Specify the size    of the applied map if it is not    3x256.
  98.            The _l_e_n_g_t_h should be a power of two, and    will be
  99.            rounded up if necessary.     If applying the map _n_c_h_a_n
  100.            must be either 1    or equal to the    number of channels in
  101.            the input map.  It may have any value if    the input map
  102.            has one channel or is not present.
  103.  
  104.       ----ssss _b_i_t_s
  105.            Specify the size    in bits    of the color map entries.
  106.            I.e., only the top _b_i_t_s bits of each color map entry
  107.            will be set.
  108.  
  109.            Exactly one of the options ----llll, ----gggg, ----tttt, ----ffff, ----mmmm, or ----rrrr,
  110.            must be specified.
  111.  
  112.       ----llll _f_a_c_t_o_r
  113.            Generate    a linear applied map with the _n_t_h entry    equal
  114.            to
  115.              _r_a_n_g_e * _m_i_n(_1._0, _f_a_c_t_o_r*(_n/(_l_e_n_g_t_h-_1))).
  116.            _F_a_c_t_o_r defaults to 1.0 if not specified.     Negative
  117.            values of _f_a_c_t_o_r    will generate a    map with values    equal
  118.            to
  119.              _r_a_n_g_e * _m_a_x(_0._0, _1._0 -
  120.            _f_a_c_t_o_r*(_n/(_l_e_n_g_t_h-_1))).
  121.  
  122.       ----gggg _g_a_m_m_a
  123.            Generate    an applied map to compensate for a display
  124.            with the    given gamma.  The _n_t_h entry is equal to
  125.              _r_a_n_g_e * (_n/(_l_e_n_g_t_h-_1))**(_1/_g_a_m_m_a).
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 12/1/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      RRRRLLLLEEEELLLLDDDDMMMMAAAAPPPP((((1111))))         1111 ((((NNNNoooovvvv 11112222,,,,    1111999988886666))))           RRRRLLLLEEEELLLLDDDDMMMMAAAAPPPP((((1111))))
  137.  
  138.  
  139.  
  140.       ----tttt _f_i_l_e
  141.            Read color map entries from a table in a    text file.
  142.            The values for each channel of a    particular entry
  143.            follow each other in the    file.  Thus, for an RGB    color
  144.            map, the    file would look    like:
  145.              red0 green0    blue0
  146.              red1 green1    blue1
  147.              ...  ...  ...
  148.            Line breaks in the input    file are irrelevant.
  149.  
  150.       ----ffff _f_i_l_e
  151.            Reads the applied map from a text file, with all    the
  152.            entries for each    channel    following each other.  Thus,
  153.            the input file above would appear as
  154.              red0 red1 red2    ... (_l_e_n_g_t_h values)
  155.              green0    green1 green2 ... (_l_e_n_g_t_h values)
  156.              blue0 blue1 blue2 ... (_l_e_n_g_t_h values)
  157.            As above, line breaks are irrelevant.
  158.  
  159.       ----mmmm _f_i_l_e_s ...
  160.            Read the    color map for each channel from    a separate
  161.            file.  The number of files specified must equal the
  162.            number of channels in the applied map.  (Note: the list
  163.            of files    must be    followed by another flag argument or
  164.            by the null flag    -------- to separate it from the _i_n_f_i_l_e
  165.            specification.
  166.  
  167.       ----oooo _o_u_t_f_i_l_e
  168.            The output will be written to the file _o_u_t_f_i_l_e if this
  169.            option is specified.  Otherwise the output will go to
  170.            _s_t_d_o_u_t.
  171.  
  172.       _i_n_f_i_l_e
  173.            The input will be taken from this file if specified.
  174.            Otherwise, the input will be read from _s_t_d_i_n.
  175.  
  176.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  177.       _a_p_p_l_y_m_a_p(1), _u_r_t(1), _R_L_E(5).
  178.  
  179.      AAAAUUUUTTTTHHHHOOOORRRR
  180.       Spencer W. Thomas, University    of Utah
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 12/1/98)
  196.  
  197.  
  198.  
  199.